

 ____  ____   __   ____  _  _  ____
(  _ \(  __) / _\ (    \( \/ )(  __)
 )   / ) _) /    \ ) D (/ \/ \ ) _)
(__\_)(____)\_/\_/(____/\_)(_/(____)

                  
READ THIS BEFORE CONTINUE
@@@@@@@@@@@@@@@@@@@@@@@@@
 

- PhpExplorator need to be copy in a folder of a web server supporting PHP 4.3.0 or better, to can run.
  You only have to type http://your_machine/folder_of_phpexplorator/phpexplorator.php in navigation bar of your browser

 ex:http://127.0.0.1/phpexplorator/phpexplorator.php
 	http://127.0.0.1/phpexplorator.php
 	http://localhost/phpexplorator/phpexplorator.php
 	http://localhost/phpexplorator/
 	
 
- To use it better PhpExplorator need a read write access to the disk. 

- It is secure to activate authentification by changing the value of 
        $PE_config["authentification_need"] = "no"; //--(url, form, no, basic, apache, 0, 1)--if require authentification
 to 
        $PE_config["authentification_need"] = "form"; //--(url, form, no, basic, apache, 0, 1)--if require authentification
 in the config.php script and change the default from
        $PE_config["my_username"] = "admin"; //--username to be use (ex:admin)
        $PE_config["my_password"] = "admin"; //--password to be use (ex:admin)
 to
        $PE_config["my_username"] = "your_new_username"; //--username to be use (ex:admin)
        $PE_config["my_password"] = "your_new_password"; //--password to be use (ex:admin)
        
After, your will insert the username, the password, and the good code you will see in the login form
  Your can also use :
         $PE_config["authentification_need"] = "basic"; //--(url, form, no, basic, apache, 0, 1)--if require authentification
or
        $PE_config["authentification_need"] = "url"; //--(url, form, no, basic, apache, 0, 1)--if require authentification

in this last case, your need to inser username and password in the url:
 ex:http://127.0.0.1/phpexplorator/phpexplorator.php?user=your_new_username&pw=your_new_password
 	http://127.0.0.1/phpexplorator.php?user=your_new_username&pw=your_new_password
 	http://localhost/phpexplorator/phpexplorator.php?user=your_new_username&pw=your_new_password
 	http://phpexplorator.sourceforge.com/phpexplorator.php?user=your_new_username&pw=your_new_password
 	
if you use:
         $PE_config["authentification_need"] = "apache"; //--(url, form, no, basic, apache, 0, 1)--if require authentification
 Your will need to configure the security at apache level using ex: .htpasswd
 
 
Using :
         $PE_config["authentification_need"] = "0"; //--(url, form, no, basic, apache, 0, 1)--if require authentification
or
         $PE_config["authentification_need"] = "no"; //--(url, form, no, basic, apache, 0, 1)--if require authentification
!!!if your don't need authentification or if you use external authentification method  !!!??



- By configure opportunely your web server (Apache, IIS, ...), you can protect more the work of PhpExplorator

- Your can make some other configuration to make phpexplorator work like you want:
  ex: by configure these parameters you can make phpexplorator more secure

        $PE_config["begin_path"] = "./"; //--begin path
        $PE_config["path_limit"] = "all"; //--(all, www, begin_path)--1 to phpexplorator path limt
        $PE_config["user_policy"] = "admin"; //--(guest, admin) PhpExplorator can write files

- You can use one file to run PhpExplorator (PhpExplorator.php). In this case you have access
 to a simple editor (textarea),  and you need to edit phpexplorator.php when you want to change a configuration value. 
 You can also rename the file [phpexplorator.php] to [index.php]
 
 * There is a mini version of phpexplorator (phpexplorator_mini) were [phpexplorator.php] was rename to [index.php]
  and the tinymce folder was deleted
 
 
- The file phpexplorator.php can be transform also in an object to be use in your own application
 1)you only need to delete these 2 last lines at the end of the file phpexplorator.php:
	$p1 = new phpexplorator();
	$p1->show();
 2) save change (you can use the name [phpexplorator.class.php] to don't make confusion)
 3) then, inport the new class in your php script and use it normally
 
 * There is a class version of phpexplorator (phpexplorator_class) were [phpexplorator.php] was
 renamed to [phpexplorator.class.php] after removing his last 2 lines
 
 example in your script:
 <?php
 	include('phpexplorator.class.php');
	$p1 = new phpexplorator();
	$p1->config['self_header']=false; // Sometimes need for use the class in another application
	$p1->show();
 ?>
 or 
<?php
	include('phpexplorator.class.php ');
	$p1 = new phpexplorator();
?>

<html>
<head>
<title>My personal page with phpexplorator </title>
</head>
<body>


<h1> here is you personal html</h1>
every html you need

<?php 
	// and here your inser your explorator class like this
	
	
	//print_r(get_object_vars('phpexplorator'));
	//print_r(get_class_methods('phpexplorator'));
	//print_r($p1->config);  
	
	$p1->config['self_header']=false; // Sometimes needed for use the class in another application
	$p1->config['authentification_need']='no';
	$p1->config['begin_path']='/home/';
	$p1->config['path_limit']='begin_path';
	$p1->config['user_policy']='guest';
	
	$p1->language = $p1->load_lang($p1->config);

	$p1->header_extra();
	$p1->header_body();

	//$p1->title();
	$p1->config = $p1->action();
	$p1->head_dir();
	$p1->dir_list();
	$p1->command_1();
	//$p1->command_2();
	$p1->command_upload();
	$p1->shell();

?>
<h1> your other personal html</h1>
</body>
</html>
 Use your creativity to make better thinks.
 
 
- PhpExplorator was created to help me continue to write script in a machine where i had  access only 
 at port 80. I wish it will be also useful for you.
 
 For any assistance or contribution, write to the forum (http://sourceforge.net/forum/?group_id=183073)
 or to (tchouamou@gmail.com).
 
 For any Donation, it can be better to just find me a job (I am a computer engineer and i can work in any part of the world).
 
 
 Thanks.
 T. Eric H.
 Adress: Yaounde (Oyomabang), Cameroon 